











                ___                            __  __             
               |_ _|_ __ ___   __ _  __ _  ___|  \/  | __ _ _ __  
                | || '_ ` _ \ / _` |/ _` |/ _ \ |\/| |/ _` | '_ \ 
                | || | | | | | (_| | (_| |  __/ |  | | (_| | |_) |
               |___|_| |_| |_|\__,_|\__, |\___|_|  |_|\__,_| .__/ 
                                    |___/                  |_|    
               --------------------       ----------------     ---
               World Wide Web Image Map Creator For RiscOS










































               ---------------------------------------------
                     This manual describes version 2.40
               ---------------------------------------------

        
        This is a conversion of the full manual with images and
                   diagrams supplied to registered users.






    CONTENTS



    Introduction...........................................................1
    Installation...........................................................1
    Important..............................................................2
    The main window........................................................3
    Tool bars - vertical...................................................4
    Tool bars - horizontal.................................................5
    Editing regions........................................................6
    Choices window.........................................................7
    Saving map files.......................................................8
    Client Side maps.......................................................9
    Server side maps......................................................10
    Error messages........................................................11
    Problems..............................................................12
    References............................................................13
    Documentation.........................................................13
    Test applications.....................................................13
    Copyright & Disclaimer................................................14
    ShareWare.............................................................14
    Licenses..............................................................15
    Distribution..........................................................15
    Contact informaton....................................................16








































    



    ImageMap
    ________________________________________________________________________


    Introduction
    

    ImageMap is a WWW image map creator. These are special images which
    have hot-spot areas. These hot-spots act in a similar manner to
    standard text links, in that a person viewing your pages can select
    them on move to another page.

    ImageMap has support for;

            o   NSCA server side image maps.
            o   CERN server side image maps.
            o   HTML client side maps as specified in the
                HTML3.2 specification.

    Installation
    

    Installing ImageMap is very simple all you need to do is copy the;

            o   !ImageMap application folder
            o   Examples folder
            o   Docs folder

    out of the distribution archive in to a new folder on your hard drive.

    To load ImageMap you need to double click on the !ImageMap folder or on
    a file type that it recognises as belong to its self. These are the
    ImageMap (&B09) and Imagen (&1BF) file types, if Imagen hasnt already
    been booted.



























                                    Page 1



    



    ImageMap
    ________________________________________________________________________



    Important
    

    Before a new image map can created it is necessary for you to have a
    base image. Its this base image that has the hot-spots created over it.
    These images can be in any format though normally they will be in;

            Acorn Sprites                JPEGs

    ImageMap will load these directly[1].  If it cant load a file directly
    then it will try to use ChangeFSI to convert them to sprites first. If
    this fails then an error will be reported.












































                                    Page 2



    



    ImageMap
    ________________________________________________________________________



    The main window
    

    ImageMap has been designed to be as easy to use as possible. It is just
    as easy to draw a shape as it is to resize it, move it or even delete
    it.

    A selected region will have all its points shown by small handles.
    These are small rectangles at the intersection of two lines. Dragging
    these will change the shape of the region whilst dragging from inside
    of the region will move the whole region its self.













































                                    Page 3



    



    ImageMap
    ________________________________________________________________________



    Tool bars - vertical
    

    When editting an image map the main window is surrounded by two extra
    tool bars. The vertical tool bar contains all the buttons that act as
    short cuts for a number of commands. Whilst the borizontal bar displays
    the dynamic information, such as the current mouse position with in the
    window.

    They are;

            o   Rectangle

                Will draw a rectangular region that will act as
                a hot spot for the image map.

            o   Circle

                Will draw a circular region that will act as a
                hot spot for the image map.

            o   Polygon

                Will draw a polygonal region that will act as a
                hot spot for the image map. Unlike the other two
                drawing tools the polygon tool can create a shape
                of n > 2 number of sides.

            o   Zoom

                This tool opens the zoom window so that you can
                change the zoom factor of the window.

            o   PCA Menu

                This tool opens a menu of all the PCA server
                applications that are currently loaded.

            o   Select

                It is with this that you can move and resize a
                region as well as selecting it for delete.














                                    Page 4



    



    ImageMap
    ________________________________________________________________________



    Tool bars - horizontal
    

    The horizontal tool bar contains;

            o   The current mouse position.

                This is the current mouse position within the
                image map. It is calculated from the top left
                hand corner.

            o   Coordinates box

                This displays the mouse pointers current
                location in the loaded imagemap. This is taken
                from the top left hand corner of the window.








































                                    Page 5



    



    ImageMap
    ________________________________________________________________________



    Editing regions
    

    Once a region has been drawn it is possible to edit it, only if it is a
    polygon. By holding down shift you can copy a region exactly very
    easily by dragging it from the center of the shape.

    If you drag a handle with shift held down you will create a brand new
    handle. This only applies to polynomal areas as you can not add
    points to rectnagular or circular areas. If you could they would no
    longer be rectangular or circular.

    To delete a handle you simply have to copy it over another handle.
    This only works for polynomal areas though, as you can not delete a
    point from the circle or rectangle areas. If you could then they would
    no longer be rectangular or circular.

    By double-clicking on a region you can alter the URL that the region
    points to....

    ....but if you double-click on a handle then you can alter its
    coordinates directly.


































                                    Page 6



    



    ImageMap
    ________________________________________________________________________



    Choices window
    

    The choices window can be accessed from the icon bar menu. Once opened,
    by selecting the Choices... menu item a window will open. This window
    has a column of option buttons running down the side of it. 

    This option buttons decide which area of ImageMap you are altering the
    choices for. The choices themseleves are displayed in the small window
    pane.

    There are currently three different sections to the Choices window.

            o   Regions

                This controls the default settings for a newly
                created region. It also contains the options for
                the background of a newly created image map.

            o   Display

                Controls the setting for the display.

            o   PCA

                Gives access to the choices offered for controlling
                the PCA support. This should be the same as offered
                by any other PCA supporting application. You can
                chose what type of the dialogue window you wish to
                use.

                   Risc OS menu            /        NCOS menu
                   Risc OS button bar      /        NCOS button bar

                You can then chose how this dialogue window is sorted.

                After that you can the enable or disable the in-place
                editting support that, when enabled, helps save space
                on the desktop.

















                                    Page 7



    



    ImageMap
    ________________________________________________________________________



    Saving map files
    

    Using ImageMap you can save your newly created image map in five
    different formats.

    The formats are...

            o   ImageMap
            o   Imagen

    Only three of the support formats can be used on the WWW though. As the
    first two are proprietary formats on used in the RiscOS world. The
    three formats that can be used on the WWW are...

            o   NSCA
            o   CERN
            o   Client side (HTML)

    The first format is ImageMap's own internal format which keeps the
    image and region data together in one format.
    The Imagen support is there to inable transfering of data between
    Imagemap and Imagen, an alternative image creator for RiscOS written by
    Justin Fletcher.

    NSCA and CERN both use a server side system, while client side maps are
    supported using the web browsing software.

    To save the image map you will need to open the main menu by clicking
    on the window with MENU. By following the Save menu item you will find
    a smaller submenu being displayed.

    When you save the image map as a client side file you can save the
    graphic as well. This will make sure that the links to the graphic are
    correct.

    No conversion is currently done to the file so if it was loaded a
    sprite it will be saved as a sprite. If it was loaded as a JPEG it will
    be saved as a JPEG [1].

















                                    Page 8



    



    ImageMap
    ________________________________________________________________________



    Client Side maps
    

    To save a client side image you need to go to the Export submenu and
    use the save HTML window.In this window are a number of choices.

            o   Save graphic
            o   Save map data only

    When the former choice is selected, ImageMap will save the base image
    in the same directory as the HTML is saved. This is always saved as
    'imagemap' and will over write any file with the same name.

    The second choice will only save the map data. This means that only the
    actual image map data will be saved. Normally when a client side image
    map is saved ImageMap will create a skelton HTML file so that the data
    can be loaded in to a web browser and checked if necessery. With this
    option selected the skeleton is not created. 

    Its useful when you have updated an existing imagemap and go to save
    the new map data in to the HTML file.



































                                    Page 9



    



    ImageMap
    ________________________________________________________________________



    Server side maps
    

    To use server side maps you need a script that will handle them, for
    Demon customers it is
    http://www.<nodename>.demon.co.uk/cgi-bin/imagemap. You also need to
    save the map in the format specified for use with the script, for Demon
    customers this is NSCA format.

    Then you need to alter you web page. To the line where you have defined
    your the graphic for the imagemap, <img src= graphics path >, you
    need to add a link around it to the uploaded map file that ImageMap
    created as well as INMAP to the img tag.

    So that you end up with something like the following[1].....

     <a href=http://www.<nodename>.demon.co.uk/cgi-bin/imagemap/main.map>
      <img src=/map.gif ISMAP>
      </a>

    Assuming that both the image and the map file containing the hot spots
    are in the root directory of the web site. If not then you will need to
    add the file path in place of main.map for the link, and likewise for
    the graphic.
































                                    Page 10



    



    ImageMap
    ________________________________________________________________________



    Error messages
    

    There are a number of different types of errors - some are nothing more
    than warnings some are far more serious. Some of the more common and
    serious ones are listed below. When the title is surrounded by single
    quotes then this is the text or part of the text that will appear in
    the warning box.

    'ImageMap requires a !ChangeFSI to have been seen by the filing system.'

    On pre-RiscOS 3.6 machines ImageMap requires ChangeFSI so that it can
    load JPEG files - on RiscOS 3.6 or above it can use the native JPEG
    handling code. It will also use ChangeFSI to load any other file format
    it doesn't understand, incase these are image file formats.

    'ImageMap requires a !Scrap directory to have been setup.'

    When using ChangeFSI, ImageMap has to create a number of temporary
    files. The standard place for these is in the !Scrap directory. If you
    have a modern Acorn compatiable boot sequence then the !Scrap folder
    should be automattically setup.

    'Address Exception'

    These is a terrible error. If this occurs with any application you
    should save any unsaved documents in to a temporary directory - not
    over the orginial in case the memory corruption has affected the
    document and then reset your machine. You should then check each of the
    files in turn to make sure they are not corrupted.


























                                    Page 11



    



    ImageMap
    ________________________________________________________________________



    Problems
    

    Below are a list of possible problems you may encounter. If you find a
    problem that is not below then you can always get help from me via the
    contact details below. 

    Q: My server side maps will not reload in the ImageMap!

    A: You need to select them in the desktop filer and then set there file
    type to &259. Once you have done this they should load correctly, but
    you must have an image loaded first. You can also press F2, when
    editing a map, and merge two or more files.

    For an image map to be created, or used, you must have a image loaded.
    This is a requirement and there is no way around it. You will need to
    drag a graphic in to ImageMap and then drag your server side map on to
    the window which opens.

    This error can also be reported when loading ImageMap files created by
    older versions or when loading Imagen files, This is because the file
    may not contain a graphic.

    Q: When I test my server side map it doesn't work / an error message
    is reported from the script program!

    A: When using a server side map it is necessary to specify the page to
    go to either with a full address http://www.<address>.com/<file name>
    or specify it relative to the root directory of your web site. So a
    file, data.map, that is in the imagemap/server/ directory on the web
    site will be defined as /imagemap/server/data.map in the URL item in
    the Where to go.... window.

    Q: When I load ImageMap for the first time the screen flashes but if I
    load it again it doesn't?

    A: This is a problem with the handling of tasks in Risc OS. It appears
    to affect the majority of applications that use PCA version 2  - as
    ImageMap does.

















                                    Page 12



    



    ImageMap
    ________________________________________________________________________



    References
    

    Documentation
    

    The main technical documentation for ImageMap was;

            o   http://www.w3.org/TR/REC-html32

    Test applications
    

    Client side maps saved by ImageMap have been tested with;

            o   MS Internet Explorer 2.01
            o   Netscape Navigator 3.00
            o   Doggysoft Web browser 1.40
            o   ANT Fresco 1.71

    NSCA Server side maps saved by ImageMap have been tested with;

            o   Doggysoft Web browser (1.36)

    I have been unable to test CERN output.































                                    Page 13



    



    ImageMap
    ________________________________________________________________________



    Copyright & Disclaimer
    

    I, the author, do not accept any liability for the loss or damage to
    your computer or any data stored on it, however caused, arising as a
    result of the use or misuse of this program.

    Unless otherwise stated the whole of the ImageMap package is  David
    McCormack

    ImageMap uses the Imagen module written by  Justin Fletcher.

    ShareWare
    

    ImageMap is ShareWare. This means that you may use ImageMap for only 30
    days as a trial period. If, after this time, you decide that you want
    to continue using ImageMap you must register it by completing the
    registration form included in the ImageMap distribution package. If you
    decide not to register ImageMap then you must either destroy all the
    copies that you have or give way all the copies that you have.

    Please support Shareware development as without your support a large
    number of high quality applications will not be written!

    The single user registration fee is currently just 10.

    The registration fee includes a disc with a fully registered copy of
    the latest version of ImageMap, and if you require it the printed
    Impression manual that is only supplied with registered copies. Please
    take note that this is not professionally printed manual but is just a
    copy printed on a bubble jet printer.
























                                    Page 14



    



    ImageMap
    ________________________________________________________________________



    Licenses
    

    There are currently two types of licence available, each with a
    different and appropriate price. They currently are;

            o   Single user

                Priced at 15, this covers any individual person.
                You may not use this version on a network of more
                than 3 machines. This includes the right to use
                ImageMap indefinitely as having the right to use new
                shareware versions when they are released.

            o   Site License

                Priced at 30 which allows the user to use ImageMap
                on 3 or more machines at any one time on a single site.

    Distribution
    

    Unregistered copies of ImageMap may be distributed freely so long as
    the following conditions are met:

            o   ImageMap must be distributed intact, excluding the
                Impression format manual which must not be distributed.
                Any alterations made to the program must be removed
                before distribution.

            o   ImageMap may only be distributed so long as no
                commercial gain or advantage is made via its
                distribution, without my prior consent. Distribution
                costs maybe charged so long as they are less than
                the equivalent of 5.00 UK sterling.

            o   ImageMap may not be distributed on any CD{\151}ROM or
                with any commercial product without my prior consent.

    Registered versions of ImageMap may not be distributed at all. They
    have the licensees name embedded in the software. Licensees of ImageMap
    may make infinite backups, so long as ImageMap is installed and used
    according the the type of licence that has been purchased.













                                    Page 15



    



    ImageMap
    ________________________________________________________________________



    Contact informaton
    

    If you wish to contact me then the details are below. I can be
    contacted by mail or e-mail at the addresses below, if you can use
    e-mail as it is much quicker and you stand a higher chance of getting a
    reply. My web address is below and the latest version of ImageMap can
    be downloaded from there.

            David McCormack,
            2 Cornwall Avenue,
            Beeston Rylands,
            Nottingham,
            NG9 1NL

            E Mail        davemac@atlantic.oaktree.co.uk
            WWW        http://www.atlantic.oaktree.co.uk/







































                                    Page 16
